.. vim: syntax=rst CHAPTER 3 ========== FLO-2D Storm Drain Data Files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Input and Output File - General ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ This chapter describes the input and output data and their format for the FLO-2D storm drain component. The storm drain input data files can be created using any storm water user interface GUI. Graphical User Interfaces that can be used to create the stUI options are: FLO-2D QGIS plug-in, GDS, EPA SWMM 5, inpPINS, Autodesk Storm and Sanitary Analysis and Civil 3D Storm and Sanitary Analysis. The following folders contain the storm drain model system: - FLO-2D PRO folder in C:\\Program Files (x86). All executable program files for the FLO-2D model including pre- and post-processing and the FLOPRO.exe are located in this folder. - FLO-2D PRO documentation folder in C:\\Users\\Public\\Documents\\FLO-2D PRO Documentation (My Documents). Manuals, Handout Documents, PowerPoint Presentations and tutorials are located in this directory. Data Input Files ^^^^^^^^^^^^^^^^ The FLO-2D data input files are generated by the QGIS plug-in or the GDS. The QGIS plug-in creates all the storm drain data files, for more information review the FLO-2D Plugin User’s Manual document. The GDS tool reads the SWMM.inp file (\*.INP file cannot be created in GDS) and pairs the inlets with grid elements. GDS creates the associated storm drain data files needed for a FLO-2D Storm Drain simulation (SWMMFLO.DAT, SWMMOUTF.DAT and SWMMFLORT.DAT). Typically, the FLO-2D grid system is prepared prior to developing the storm drain model. The QGIS plug-in or the GDS will generate the files needed to run the FLO-2D Storm drain model. The following data files have to be created to run a FLO-2D storm drain simulation. CONT.DAT '''''''' This file contains the simulation control parameters: - Set SWMM = 1 to initiate the storm drain component, review the DATA INPUT MANUAL.DAT file for more information about this switch. - For no storm drain simulation, SWMM = 0 (default). SWMM.inp '''''''' SWMM.inp is the input file that contains most of the storm drain project data. It includes pipe network geometry, inlet/outlet and junction locations, simulation control settings and hydraulic routing properties. The pipe network components in the SWMM.inp have to be created with QGIS plug-in or other third-party storm drain software like SWMM GUI. Table 5 lists the section data in the SWMM.inp file. GDS does not create the SWMM.INP file but it reads the file. Each section of the SWMM.inp file begins with a keyword. **Table 5. Sections that Enclose Data in the SWMM.inp (Rossman, 2005)** .. raw:: html
| [TITLE] | Project title |
| [OPTIONS] | Analysis options |
| [REPORT] | Output reporting instructions |
| [FILES] | Interface file options |
| [JUNCTIONS] | Junction node information |
| [OUTFALLS] | Outfall node information |
| [DIVIDERS] | Flow divider node information |
| [STORAGE] | Storage node information |
| [CONDUITS] | Conduit link information |
| [PUMPS] | Pump link information |
| [ORIFICES] | Orifice link information |
| [WEIRS] | Weir link information |
| [OUTLETS] | Outlet link information |
| [XSECTIONS] | Conduit, orifice, and weir cross-section geometry |
| [TRANSECTS] | Transect geometry for conduits with irregular cross-sections |
| [LOSSES] | Conduit entrance/exit losses and flap valves |
| [CONTROLS] | Rules that control pump and regulator operation |
[TITLE]
INP file created on 10/17/2014 9:30:50 AM by FLO-2D Team Title/Notes:
[OPTIONS]
FLOW_UNITS CFS
INFILTRATION HORTON
FLOW_ROUTING DYNWAVE
START_DATE 03/25/2013
START_TIME 00:00:00
REPORT_START_DATE 03/25/2013
REPORT_START_TIME 00:00:00
END_DATE 03/25/2013
END_TIME 00:24:00
SWEEP_START 01/01
SWEEP_END 12/31
DRY_DAYS 0
REPORT_STEP 00:01:30
WET_STEP 00:01:00
DRY_STEP 00:01:00
ROUTING_STEP 0.05
ALLOW_PONDING YES
INERTIAL_DAMPING PARTIAL
VARIABLE_STEP 0.00
LENGTHENING_STEP 0
MIN_SURFAREA 0
NORMAL_FLOW_LIMITED BOTH
SKIP_STEADY_STATE NO
FORCE_MAIN_EQUATION D-W
LINK_OFFSETS DEPTH
MIN_SLOPE 0
[EVAPORATION]
;;Type Parameters
;;---------- ----------
CONSTANT 0.0
DRY_ONLY NO
[JUNCTIONS]
;; Invert Max. Init. Surchage Ponded
;; Name Elev. Depth Depth Depth Area
;; ---- ------ ------ ------ --------- -------
I1CP1C14 1264.35 6.34 0 0 0
[OUTFALLS]
;; Invert Outfall Stage/Table Tide
;; Name Elev. Type Time Series Gate
;;-------------- ---------- ---------- ---------- ----
OUTFALL 1254.20 FREE NO
[CONDUITS]
;; Inlet Outlet Manning Inlet Outlet Init. Max.
;;Name Node Node Length N Offset Offset Flow Flow
;;-------------- ---------------- ---------------- ---------- ----------
C1 PJ1C1 FOUTFALL 176 0.013 0 0 0 0
[XSECTIONS]
;;Link Shape Geom1 Geom2 Geom3 Geom4 Barrels
;;-------------- ------------ ---------------- ---------
C1 CIRCULAR 10 0 0 0 1
[LOSSES]
;;Link Inlet Outlet Average Flap Gate
;;-------------- ---------- ---------- ---------- ----------
[REPORT]
INPUT YES
CONTROLS YES
NODES ALL
LINKS ALL
[TAGS]
[MAP]
DIMENSIONS 696350.607 908521.547 697144.791 909040.891
Units None
[COORDINATES]
;;Node X-Coord Y-Coord
;;-------------- ------------------ ------------------
I1CP1C14 696446.346 908983.021
[VERTICES]
;;Link X-Coord Y-Coord
;;-------------- ------------------ ------------------
SWMMFLO.DAT
'''''''''''
A node must have an ID starting with an ‘I’ to differentiate the inlet from a junction.
Surface water discharge is only shared between nodes that have the correct ID assigned in the \*.inp file.
Inlets are automatically paired by the QGIS plug-in or GDS to a corresponding FLO-2D grid element.
The SWMMFLO.DAT file contains the inlet geometry as well as the names or numbers that identify the inlet that is paired with the grid cell (Table 6).
**Table 6.
SWMMFLO.DAT Variables**
.. raw:: html
SWMMFLO.DAT File Variables
Line 1 to Number of Inlets (JT):
SWMMCHAR=‘D’ SWMM_JT(JT) SWMM_IDEN(JT) INTYPE(JT) SWMMlength(JT)
SWMMwidth(JT) SWMMheight(JT) SWMMcoeff(JT) FLAPGATE(JT)CURBHEIGHT(JT)
Notes:
Multiple Inlets (SWMM_IDEN(JT)) assigned to the same grid cell(SWMM_JT(JT)) constitutes a data error.
An Inlet (SWMM_IDEN(JT)) assigned to more than one grid cell(SWMM_JT(JT)) constitutes a data error.
SWMMFLO.DAT
D 452161 I19CP1SEMDRHRL 1 12 0 0.417 3 0 0
D 451297 I20CP1SEMDRHRL 1 4.8 0 0.417 3 0 0
D 451302 I21CP1SEMDRHRL 1 12 0 0.417 3 0 0
D 450875 I21CP2SEMDRHRL 3 6 4.4 0 3 0 0
D 441072 I22CP1SEMDRHRL 1 12 0 0.417 3 0 0
D 440649 I22CP2SEMDRHRL 3 5 3.0 0 3 0 0
SWMMOUTF.DAT File Variables
Line 1 to Number of Outfalls (JT):*OUTF_NAME(JT) OUTF_GRID(JT) OUTF_FLO2DVOL(JT)
SWMMOUTF.DAT File Example
OF1 72565 1OF2 98863 0OF3 97479 1OF4 51882 1OF5 216195 0OF7 382089 1
ID Grid Cell
ID Depth Discharge
ID Depth Discharge
ID Depth Discharge
…
The first pair of numbers should be zero depth and zero discharge.
This is repeated from 1 to number of storm drain inlets with INTYPE= 4 (Table 12).
**Table 12.
SWMMFLORT.DAT Variables**
.. raw:: html
SWMMFLORT.DAT File Variables
Line 1 to Number of INTYPE 4 (JTSWMM(JT)):
SWMMCHARRT GRIDCELL SWMMType4ID
SWMMCHARRT DEPTHSWMMRT(JTSWMM(JT),K) QSWMMRT(JTSWMM(JT),K)
SWMMFLORT.DAT File Example
D 153076 I4-85
N 0.00 0.00
N 0.70 10.00
N 1.12 20.00
N 1.46 30.00
N 1.77 40.00
N 2.06 50.00
N 2.32 60.00
N 2.57 70.00
N 2.81 80.00
D 199236 I4-196
N 0.00 0.00
N 0.79 10.00
N 1.19 20.00
N 1.56 30.00
N 1.89 40.00
N 2.19 50.00
N 2.47 60.00
N 2.74 70.00
ID Grid Cell Inlet ID Clogging Factor - Cf(%) Time for clogging -Tc(hr)
D 2694 I1 25 0.50
D 2409 I2 50 3.25
.. image:: img/Chapter3/Chapte008.jpg
*Figure 48.
GDS Dialog Box for Entering clogging factor data.*
SWMM.ini
''''''''
After a project is saved in the storm drain GUI, the control settings file SWMM.ini will automatically be generated.
This file has the same name as the project file and the extension \*.ini.
It contains global settings and model output options such as map display, legend colors and intervals, object default values, etc.
To enable the display of results in the storm drain GUI the user must set the last two lines in Figure 49 as shown.
.. image:: img/Chapter3/Chapte009.jpg
*Figure 49.
SWMM.ini file.*
Output files
^^^^^^^^^^^^
With the successful completion of a FLO-2D storm drain simulation, the storm drain output files will be created in the simulation folder.
Table 15 list the storm drain output files and the description.
**Table 15.
List of the Storm Drain Data Output Files and Description**
.. list-table::
:widths: 50 50
:header-rows: 0
* - **Output File**
- **Description**
* - SWMM.RPT
- Output report file generated by the storm drain model at the end of a simulation containing
the pipe routing results for each output interval.
* - SWMM.OUT
- Output file in a binary format that contains the storm drain results.
This file is similar to the SWMM.RPT file and it is used by the SWMM GUI to interactively
create time series plots and tables, profile plots, and
statistical analyses of the results.
* - SWMMQIN.OUT
- Reports the inflow and return flow discharge for each storm drain inlet.
The reported discharges may be different from those in the SWMM.RPT file
since the storm drain results include lateral pipe inflow and outflow.
* - SWMMOUTFIN.OUT
- This file reports the outfall hydrographs for return flow to the surface water system.
This file lists the grid or channel element in the first line followed by the time and discharge pairs.
* - FPRIMELEV.OUT
- This output file reports the differences in elevation between the rim/invert elevation
in the SWMM.inp file and the FLO-2D grid element elevation.
This file should be reviewed to evaluate the elevations representing the inlet reference.
* - StormDrain_ERROR.CHK
- This output file reports the storm drain error and warning messages.
They were removed from the ERROR.CHK file.
* - SDManholePopUp.OUT
- This output file reports the information for the manhole popping in the storm drain system.
The information reported is: manhole name, time of occurrence, elevation comparison for the popping.
* - ManholePop.OUT
- This output file reports the information for the manhole popping in the storm drain system in a table.
The information reported is: X coordinate, Y coordinate, grid cell, manhole name,
time of occurrence, pressure head, rim + surcharge depth, WSE.
* - FPLAIN_SDElev.RGH
- Changes in elevation (FPRIMELEV.OUT) are reported to the FPLAIN_SDElev.RGH file.
Replace the FPLAIN.DAT file to apply the changes to the next simulation
* - TOPO_SDElev.RGH
- Changes in elevation (FPRIMELEV.OUT) are reported in the TOPO_SDElev.RGH.
Replace the TOPO.DAT file to apply the changes to the next simulation.
* - UndergOUTFALLS.CHK
- This output file reports the underground outfalls, the invert elevation of the outfall,
the grid cell elevation and the difference between them.
* - SUMMARY.OUT
- Volume conservation, run time, and final disposition of the volumes between the model components are reported in this file.
The storm drain volume is reported as:
1. Storm Drain Inflow in the inflow volume that flows from surface water to storm drain
system through inlets and outfalls (compare total w/SWMM.rpt Wet Weather Inflow):
- SURFACE TO STORM DRAIN SYSTEM THROUGH INLETS: Volume that flows from surface water to
storm drain network through the inlets.
- SURFACE TO STORM DRAIN THROUGH OUTFALLS: Volume that flows from surface water to storm drain
network through the outfalls as backwater.
- DIRECT INFLOW RECEIVED AT INLETS: volume that enters the system from outside of the domain.
- TOTAL INFLOW (compare w/SWMM.rpt Wet Weather Inflow).
2. Storm Drain Outflow from Outfalls is the volume that leaves the storm drain system through
outfalls (compare total w/SWMM.rpt External Outflow):
- STORM DRAIN TO SURFACE THROUGH OUTFALLS: Volume that flows from the storm drain to the surface
water through the outfalls. Only those outfalls that were turned ‘on’ in the SWMMOUTF.DAT will
discharge the volume back to the surface layer.
- STORM DRAIN OUTFALL (OFF SYSTEM): Volume that flows off the storm drain through the outfalls.
Only those outfalls that were turn ‘off’ in the SWMMOUTF.DAT will discharge the volume off the storm drain system.
- TOTAL OUTFLOW (compare w/SWMM.rpt External Outflow)
3. Storm Drain Return Flow to Surface
- STORM DRAIN RETURN FLOW TO SURFACE THROUGH INLETS: Volume that returns to the surface water through inlets.
- TOTAL STORM DRAIN RETURN FLOW + OUTFLOW: Volume that returns to the surface water from the storm
drain network plus outflow. Return volume is possible when the storm drain pressure head is greater
than both the RIM elevation and the FLO-2D water surface elevation in the inlet grid element.
4. STORM DRAIN SYSTEM STORAGE: volume in the pipe system at the end of the simulation.
This volume is extracted from the swmm.RPT file.
5. STORM DRAIN RETURN FLOW + OUTFLOW + STORAGE
6. STORM DRAIN MASS BALANCE: mass balance volume conservation calculated as:
Total Inflow - Total Outflow - Total Storm Drain Return Flow - Storm Drain System Storage
7. Extracted from Storm Drain File (swmm.rpt):
- WET WEATHER INFLOW: Compare with Storm Drain Inflow.
- EXTERNAL INFLOW: Other node inflows in addition to any surface runoff such as direct inflows
as user-defined time series, dry weather inflows that are continuous inflows as base flows,
and rainfall dependent infiltration/inflow (RDII).
- EXTERNAL OUTFLOW: Compare with Storm Drain Outflow from Outfalls.
- Return Flow to Surface: Compare with STORM DRAIN RETURN FLOW TO SURFACE THROUGH INLETS.
- Total Storm Drain Storage (nodes + links): Sum of the storage.
- Continuity Error (%)
* - CHVOLUME.OUT
- This file reports the channel flow distribution including inflow, outflow, overbank flow,
infiltration losses and volume conservation.
This includes the volumes for channel outflow to the storm drain and channel inflow from the storm drain.
* - ERROR.CHK
- This FLO-2D file contains input data error warnings and messages for the surface model.
This file should be reviewed for messages after each simulation.